home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / General / SC++ 7.0.2 Update / Release Notes / Visual Architect READ ME < prev   
Text File  |  1994-05-19  |  8KB  |  216 lines
  1. Visual Architect 7.0.1 READ ME
  2. ==============================
  3. Copyright ©1994 Symantec Corporation. All Rights Reserved.
  4. May 8, 1994
  5. Font: Geneva 12
  6.  
  7. This file contains last minute corrections and additions pertaining
  8. to the Visual Architect application that are not described in the 
  9. Visual Architect/THINK Class Library Guide.
  10.  
  11. Tutorial Errata
  12. ==============
  13. The Beeper Tutorial (Chapter 5 of the Visual Architect/THINK Class 
  14. Library Guide) requires the following changes:
  15.  
  16. • On page 41, figure 4-5 should be:
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35. • Also on page 41, Step 2 should read as follows:
  36.  
  37.  2. In the New View dialog box, type BeeperDialog in the field Name, 
  38.      select Modal Dialog from the View Kind popup, and click OK.
  39.  
  40.  
  41. • On page 43, Step 1 should read as follows:
  42.  
  43. 1.  Choose the Edit Text tool from the Tool Palette. Note that the cursor 
  44.    changes to a cross hair when it is over the dialog box. Click the cursor to 
  45.    the right of the static text pane you just added, to position the edit text pane.
  46.    An edit text box appears. Now press Return or Enter to edit the defualt static
  47.    text. Type the number "2", and then type  Enter a second time to finish
  48.    the edit task.
  49.  
  50.    You can constrain the type of text the user is allowed to enter into the edit 
  51.    text pane by selecting a special THINK Class Library class, as shown in the next
  52.    step. The edit text pane then becomes an instance of this class.
  53.  
  54. • In Chapter 6, the Process Monitor tutorial, p. 73: The first sentence of Step 2
  55.    should read:
  56.  
  57. 2. Choose Pane Info from the Pane menu (Command-L), or double-click the button
  58.    pane.
  59.  
  60.  
  61. Converting from Classy to Visual Architect
  62. =======================================
  63.  
  64. Visual Architect can read existing Classy resource files, however a few steps 
  65. must be taken to properly convert all of the view information. These steps are:
  66.  
  67. 1. Open the Classy Resource file using Visual Architect
  68. 2. For each view, do the following:
  69.     a. Open the view
  70.     b. Modify the view in some trivial way. The easiest thing is to do a Select All
  71.         (command-a) and then move all the panes one step to the left, and then back
  72.         one step to the right by pressing the left and right arrow keys, respectively
  73. 3. Select Save from the File menu to save the converted resource file
  74.  
  75.  
  76. Common Mistakes
  77. ================
  78.  
  79. When working with Visual Architect, keep in mind that it creates two 
  80. "levels" of files for your application. All files that begin with "x_" are
  81. files that are modified as needed by Visual Architect. You should NOT make
  82. changes directly to any of the "x_" files, since Visual Architect will just 
  83. overwrite that file. Any user changes should always be in the upper level 
  84. files.
  85.  
  86.  
  87. Automatic Window Closing
  88. ========================
  89.  
  90. Anytime that Visual Architect generates a file, it will check with the THINK
  91. Project Manager to see if that file is open in the Editor. If it is, Visual 
  92. Architect will ask the THINK Project Manager to close the window. As a result, 
  93. you will notice from time to time that editor windows showing lower layer ("x_")
  94. files are automatically closed during the generate phase of Visual Architect. When 
  95. the generate phase is complete, you can again open any lower layer files in the
  96. THINK Project Manager's editor.
  97.  
  98.  
  99. File IDs in the Application Info dialog
  100. ==================================
  101.  
  102. Visual Architect's Application Info dialog (opened by choosing Application from
  103. the Edit menu) allows you to specify File IDs that the application will use. Keep in 
  104. mind that these IDs must be four character constants like 'doc1' or 'MyDc'. If you 
  105. don't enter four character, Visual Architect will display a validation dialog to 
  106. remind you.
  107.  
  108.  
  109. Using Hierarchical Menus
  110. ========================
  111.  
  112. When you create a menu item that has a hierarchical submenu attached, 
  113. that menu item will have cmdNull assigned as its default command by
  114. Visual Architect. Because of the way that the THINK Class Library enables
  115. menus, this means that the menu item containing hierarchical items will
  116. be disabled, even if some or all of the hierarchal items should be 
  117. enabled. To cause the menu item to be enabled, you need to create a dummy 
  118. command handled by the appropriate view or application class. Then assign 
  119. this command to the menu item containing the hierarchical menu. 
  120.  
  121. For example, if there is to be a menu item called 'Foo' in the File menu 
  122. that has a hierarchic menu that should be enabled when the 'Main' document
  123. is active, follow the following steps:
  124.  
  125. 1.  Create a new command named cmdDummyFoo
  126. 2.  Set the In Class: pop up for the command to be CMain
  127. 3.  Set the command action to "None"
  128.  
  129. Now the Foo menu item will be enabled any time a 'Main' document window
  130. is the frontmost window.
  131.  
  132.  
  133. Creating Multiple Columns for CArrayPane Derived Classes
  134. =====================================================
  135.  
  136. When creating CArrayPane panes in Visual Architect, you cannot specify the
  137. number of columns in the Pane Info dialog. To create a multi-column table,
  138. you can use the  following technique in your CArrayPane's GetFrom() member
  139. function:
  140.  
  141. void    MyArrayPane::GetFrom(
  142.     CStream     &aStream)
  143. {
  144.         // Get any additional data members for this class
  145.         // before calling the superclass GetFrom
  146.  
  147.  
  148.                                         /* Let superclass restore            */
  149.     x_MyArrayPane::GetFrom(aStream);
  150.  
  151.   // Next three lines of code set up a multicolumn table
  152.   DeleteCol(1,1);              // One column is automatically created, we delete it here
  153.                                        // so that default column width will be honored
  154.  
  155.   AddCol(someCols, -1);       // someCols is the number of columns for your table
  156.   AddRow(someRows, -1);    // someRows is the number of rows for your table
  157.  
  158.         // Restore any subordinate objects below
  159.  
  160. }
  161.  
  162. Fixed in Visual Architect 7.0.1
  163. =======================
  164.  
  165. • Cmd-U is now used exclusively for Bring Up To Date (like TPM)
  166. instead of Underline.
  167.  
  168. • Balloon Help is now disabled in menu dialogs.
  169.  
  170. • The Tools menu is now deactivated when a TearoffMenu is in front.
  171.  
  172. • CPane height, width, hEncl and vEncl now show their correct values
  173. when pane is enclosed in a scrollpane. This allows users to change
  174. the pane size and offset.
  175.  
  176. • The Tools palette is now hidden and the Tools menu disabled when a
  177. Pane Info window is frontmost.
  178.  
  179. • If you Generate All then Run, VA won't generate again.
  180.  
  181. • VA now asks TPM to close and mark changed all generated header files.
  182.  
  183. • Comments in generated files now refer to .cp instead of .c files.
  184.  
  185. • Cmd-I no longer changes the size of CEditText items. 
  186.  
  187. • CShapeButton unhilites appropriately.
  188.  
  189. • VA-defined data members of type long can now be properly set in
  190. Pane Info.
  191.  
  192. • Pane Info is no longer enabled when a view is selected in the 
  193. document window.
  194.  
  195. • Unchecking "use file" for a document now generates compilable
  196. code.
  197.  
  198. • Identifier in Pane Info is now validated to be <= 31 characters,
  199. a valid C identifier and unique within the view.
  200.  
  201. • Entering duplicate command names is not allowed.
  202.  
  203. • Changing the class of a pane while its Pane Info dialog is open
  204. dismisses the dialog (instead of scrambling it or crashing).
  205.  
  206. • The Pane Info for CArrayPanes no longer includes the number of
  207. columns.
  208.  
  209. • Deleting a view now forces a Generate All. (The user must still manually
  210. remove the view class from the project, if necessary, but other generated
  211. files will not refer to the class.) If a file is closed with a Generate
  212. All pending, it will be remembered when the file is reopened.
  213.  
  214. • Opening a file will fail if the file was written by a later version of VA.
  215.  
  216.